
@C1@c@b@_ Text

     To render arbitrary text on top of an image. The text so rendered
     can be either part of the raster or exists as a separate entity.
     Text with mixed fonts (mainly symbol font) can be entered the same
     as in TeX(1), e.g., to get math symbol, pi, type 
@f   $\pi$

@b Interaction
     To enter text, simply type into the text control panel. The new text
     is shown as soon as it is typed both in the main window and in the
     control panel (input that reqires font switching or special symbol
     handling may cause a delay in rendering until a command is complete).

     To change size, font or direction of the text, simply clicking the
     mouse on appropriate buttons. To move text to a new location, click
     leftmouse at the new location (in the viewing window). Arrow keys
     and ijkl (same as in VI) can be used for precise placement. 
     [1-9] controls keyboard command step size.

     To place the text into the image, press OK button. To exit
     text mode, press Done button.

@b More Details
     Distinctions are made for text that will become part of the raster
     from that which will exist separately from the raster, hence the
     two different rendering options: Immediate and Deferred. In Immediate
     mode, all text rendered will be part of raster while in Deferred
     mode, text exists as a separate entity. The deferred mode is most 
     useful for generating hardcopies via, say, PostScript, because the
     printer has a much higher resolution than the screen and scan
     conversion done by the printer looks much better.  Depending on your 
     application, you can choose one of the two method by pressing on the 
     Immediate/Deferred button. 

     All special effects (shadow, engraved and embossed etc) need some 
     experimentation to look nice. The rule of thumb is that for engraved
     and embossed to look nice, the text should not be weaker than the
     background.


@b Note
   1. Always use proper justification with placement of text if hardcopies
      via PostScript are desired. Switching to the PrinterFont gives a better
      approximation to what the string length would be on paper, it is not
      exact. If you want to have the current string centered at (x,y), do 
      so by choosing center-justification. Remember that due to limitation of 
      the screen resolution and/or available screen font sizes, text placed 
      centered at (x,y) and text placed flushed-left at (x-w,y) may look very 
      different on hardcopies even if they look the same on screen, even
      with PrinterFont on.
   2. In immediate mode, strings that are outside the image can't be rendered.
      To place a string outside the image, enlarge the image via cropping
      and then render the text. 
   3. If your machine is not capable of hardware double buffering, bit
      simulates double buffering in software. Due to some technical
      reasons, text/background/frame color sometime is screwed. If that
      happens, turn off simulation via Setup (the flag is SimuDBLBuffer).
